home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / uucp / wcnews_1_0_30.lha / doc / inews.readme < prev    next >
Text File  |  1992-12-14  |  3KB  |  84 lines
  1. INEWS as of Mon, 14 Dec 1992 03:11:42 +0100
  2. -------------------------------------------
  3.  
  4. SYNOPSIS
  5.    inews <file [-h] [-x excluded-site] [-V] [-W] [-a Approved:-
  6.          contents] [-c Control:-contents] [-d Distribution:-contents]
  7.          [-e Expires:-contents] [-f From:-contents] [-n Newsgroups:-
  8.          contents] [-o Organization:-contents] [-r Reply-To:-contents]
  9.          [-t Subject:-contents] [-C newsgroup ] [-F References:-contents]
  10.          [+oi]
  11.  
  12.          (see inews.man for further information of std. options (`-x'))
  13.  
  14. FUNCTION
  15.    Reads article, adds/modifies certain headers according to RFC 822/1036
  16.    and files the article in the in.coming directory, thus it will be
  17.    processed by relaynews next time unbatch runs.
  18.  
  19.    If you specify -W on the commandline, instead of spooling the article
  20.    in in.coming, it is directly piped into relaynews. This is useful in
  21.    some cases (you will know that your article has been relayed properly)
  22.    but may take some time if there is currently a large newsbatch being
  23.    processed (i. e. `relaynews' (or `fixactive' which locks `relaynews')
  24.    is currently running).
  25.  
  26.    Based on a `Content-Transfer-Encoding:' header, the article's body will
  27.    be processed by `mmencode' or modified internally to match the requested
  28.    CTE. Be sure to have `mmencode' (comes with metamail) installed, otherwise
  29.    you won't be able to post any news with CTE's of `quoted-printable' or
  30.    `base64' (`7bit', `8bit' and `binary' are handled internally).
  31.  
  32.    In case of problems, you will get your article mailed to you (should
  33.    work, but needs more tests!) ...
  34.  
  35.    NEW FEATURES: `+o' tells inews to overwrite some header which usually
  36.                  are passed through.
  37.                  Currently implemented:
  38.                     `i' for `Message-ID:' (`+oi')
  39.  
  40.    RESTRICTIONS: `-C group' (supposed to create `group') is not implemented
  41.                  yet.
  42.                  `-x excluded-site' only works with `-W'.
  43.                  Specifying several files as input instead of stdin is not
  44.                  implemented (yet).
  45.                  `-A' (wait for enough space on news partition) isn't
  46.                  implemented.
  47.                  The bogus `-M' (`does nothing, for B news compatibility')
  48.                  is not implemented -- and will never be.
  49.  
  50.  
  51. CONFIGURATION, FILES, ETC.
  52.    You can set the newsname() in several ways in this order:
  53.  
  54.     - INewsDomain from uulib:Config
  55.     - UULIB:news/whoami (you may redirect `UULIB:' as usual in DUUCP)
  56.     - $HOSTNAME
  57.     - NODENAME (+ DOMAINNAME if DOMAINPATH=="y") from uulib:Config
  58.  
  59.    newsname() is used in generating `Path:', `Message-Id:' & `Sender:'.
  60.  
  61.    The in.coming directory is specified by GetConfigDir(UUNEWS)+"in.coming/"
  62.    and the filename is "0000000xabcdaffe", i. e. time(NULL), GetSequence(1)
  63.    and FindTask(NULL).
  64.  
  65.    Note that the programs `relaynews', `sendmail' and `mmencode' are
  66.    expected to be in the current search path; there is NO WAY to specify
  67.    alternatives.
  68.  
  69.    Please make sure you have an entry for `news' in your `uulib:passwd',
  70.    e. g.
  71.  
  72.    news,/&"!%!V,2,2,Where No News Have Gone Before,UUPUB:,*t
  73.  
  74.    If you are using a different news system than `wCNews', you probably
  75.    will only be able to use the `-W' mode (causing inews piping the
  76.    article into relaynews directly).
  77.  
  78.    Please note that inews requires AmigaOS 2.0 or higher.
  79.  
  80.  
  81. BUGS, SUGGESTIONS, MONEY =:->
  82.    In case of any problems, feel free to email me: <bugs@hactar.hanse.de>.
  83.  
  84.